Contexto global

PutFileToServerAsync

Variante de sintaxis: Por ruta al archivo

Sintaxis:

PutFileToServerAsync(<CallbackDescriptionOnProgress>, <CallbackDescriptionBeforeStart>, <Dirección>, <RutaAlArchivo>, <IDÚnicoDelFormulario>)

Parámetros:

Tipo: CallbackDescription.
Contiene la descripción del procedimiento que se llamará varias veces a medida que se coloca el archivo. El número de llamadas y el tiempo de llamada no están estrictamente definidos. La notificación se llama con los siguientes parámetros:

• <ArchivoAInsertar> – tipo: FileRef. Referencia al archivo colocado en el almacenamiento temporal.
• <Colocado> – tipo: Número. Porcentaje de la parte del archivo colocada.
• <CancelarColocaciónDeArchivo> – tipo: Booleano. Indica que se cancela la colocación adicional del archivo en el almacenamiento. Si establece el valor del parámetro en Verdadero en el módulo del procedimiento controlador, se cancelará la colocación del archivo en el almacenamiento. El valor predeterminado es Falso. El parámetro devuelto.
• <ParámetrosAdicionales> – un valor especificado al crear el objeto CallbackDescription.

Tipo: CallbackDescription.
Contiene la descripción del procedimiento que se llamará antes de que se almacene el archivo. La notificación se llama con los siguientes parámetros:

• <ArchivoAInsertar> – tipo: FileRef. Enlace al archivo listo para ser colocado en un almacenamiento temporal.
• <CancelarColocaciónDeArchivo> – tipo: Booleano. Indica que se cancela la colocación adicional del archivo en el almacenamiento. Si establece el valor del parámetro en Verdadero en el módulo del procedimiento controlador, se cancelará la colocación del archivo (en este caso, no se llamarán otras notificaciones). El valor predeterminado es Falso. El parámetro devuelto.
• <ParámetrosAdicionales> – un valor especificado al crear el objeto CallbackDescription

}

Tipo: Cadena.
Contiene una dirección de archivo en el almacenamiento temporal por la cual se debe colocar el archivo del disco duro. Si no se especifica o es una cadena en blanco, se creará un nuevo archivo.

Tipo: Cadena.
Ruta a un archivo en el disco duro.

Tipo: UUID.
El UUID del formulario que se puede obtener con la propiedad UUID de un formulario de aplicación cliente. El archivo se guarda en un almacenamiento temporal y se elimina después de que se elimina el objeto de formulario.
Si omite este parámetro, el valor almacenado se borra después de la siguiente llamada al servidor desde un módulo común, o en una llamada al servidor de contexto o no de contexto desde un formulario, o en una llamada al servidor desde un módulo de comando, o al obtener un formulario.

Descripción de la variante del método:

Coloca un archivo especificado como una ruta en el disco duro desde el sistema de archivos local en el almacenamiento temporal.
La extensión del sistema de archivos es necesaria en el cliente web.
El controlador <CallbackDescriptionOnProgress> solo se llama dos veces en el cliente web: cuando el número de bytes colocados en el almacenamiento temporal es 0 y cuando es igual al tamaño completo del archivo.

Variante de sintaxis: Por enlace a un archivo

Sintaxis:

PutFileToServerAsync(<CallbackDescriptionOnProgress>, <CallbackDescriptionBeforeStart>, <Dirección>, <FileRef>, <IDÚnicoDelFormulario>)

Parámetros:

Tipo: CallbackDescription.
Contiene la descripción del procedimiento que se llamará varias veces a medida que se coloca el archivo. El número de llamadas y el tiempo de llamada no están estrictamente definidos. La notificación se llama con los siguientes parámetros:

• <ArchivoAInsertar> – tipo: FileRef. Referencia al archivo colocado en el almacenamiento temporal.
• <Colocado> – tipo: Número. Porcentaje de la parte del archivo colocada.
• <CancelarColocaciónDeArchivo> – tipo: Booleano. Indica que se cancela la colocación adicional del archivo en el almacenamiento. Si establece el valor del parámetro en Verdadero en el módulo del procedimiento controlador, se cancelará la colocación del archivo en el almacenamiento. El valor predeterminado es Falso. El parámetro devuelto.
• <ParámetrosAdicionales> – un valor especificado al crear el objeto CallbackDescription.

Tipo: CallbackDescription.
Contiene la descripción del procedimiento que se llamará antes de que se almacene el archivo. La notificación se llama con los siguientes parámetros:

• <ArchivoAInsertar> – tipo: FileRef. Enlace al archivo listo para ser colocado en un almacenamiento temporal.
• <CancelarColocaciónDeArchivo> – tipo: Booleano. Indica que se cancela la colocación adicional del archivo en el almacenamiento. Si establece el valor del parámetro en Verdadero en el módulo del procedimiento controlador, se cancelará la colocación del archivo (en este caso, no se llamarán otras notificaciones). El valor predeterminado es Falso. El parámetro devuelto.
• <ParámetrosAdicionales> – un valor especificado al crear el objeto CallbackDescription

}

Tipo: Cadena.
Contiene una dirección de archivo en el almacenamiento temporal por la cual se debe colocar el archivo del disco duro. Si no se especifica o es una cadena en blanco, se creará un nuevo archivo.

Tipo: FileRef.
Enlace al archivo.

Tipo: UUID.
El UUID del formulario que se puede obtener con la propiedad UUID de un formulario de aplicación cliente. El archivo se guarda en un almacenamiento temporal y se elimina después de que se elimina el objeto de formulario.
Si omite este parámetro, el valor almacenado se borra después de la siguiente llamada al servidor desde un módulo común, o en una llamada al servidor de contexto o no de contexto desde un formulario, o en una llamada al servidor desde un módulo de comando, o al obtener un formulario.

Descripción de la variante del método:

Coloca un archivo especificado como una referencia de archivo desde el sistema de archivos local en el almacenamiento temporal.
La extensión de operación de archivo no es necesaria en el cliente web.

Variante de sintaxis: Usando el cuadro de diálogo de selección de archivo

Sintaxis:

PutFileToServerAsync(<CallbackDescriptionOnProgress>, <CallbackDescriptionBeforeStart>, <Dirección>, <ParámetrosDeDiálogo>, <IDÚnicoDelFormulario>)

Parámetros:

Tipo: CallbackDescription.
Contiene la descripción del procedimiento que se llamará varias veces a medida que se coloca el archivo. El número de llamadas y el tiempo de llamada no están estrictamente definidos. La notificación se llama con los siguientes parámetros:

• <ArchivoAInsertar> – tipo: FileRef. Referencia al archivo colocado en el almacenamiento temporal.
• <Colocado> – tipo: Número. Porcentaje de la parte del archivo colocada.
• <CancelarColocaciónDeArchivo> – tipo: Booleano. Indica que se cancela la colocación adicional del archivo en el almacenamiento. Si establece el valor del parámetro en Verdadero en el módulo del procedimiento controlador, se cancelará la colocación del archivo en el almacenamiento. El valor predeterminado es Falso. El parámetro devuelto.
• <ParámetrosAdicionales> – un valor especificado al crear el objeto CallbackDescription

Tipo: CallbackDescription.
Contiene la descripción del procedimiento que se llamará antes de que se almacene el archivo. La notificación se llama con los siguientes parámetros:

• <ArchivoAInsertar> – tipo: FileRef. Enlace al archivo listo para ser colocado en un almacenamiento temporal.
• <CancelarColocaciónDeArchivo> – tipo: Booleano. Indica que se cancela la colocación adicional del archivo en el almacenamiento. Si establece el valor del parámetro en Verdadero en el módulo del procedimiento controlador, se cancelará la colocación del archivo (en este caso, no se llamarán otras notificaciones). El valor predeterminado es Falso. El parámetro devuelto.
• <ParámetrosAdicionales> – un valor especificado al crear el objeto CallbackDescription

}

Tipo: Cadena.
Contiene una dirección de archivo en el almacenamiento temporal por la cual se debe colocar el archivo del disco duro. Si no se especifica o es una cadena en blanco, se creará un nuevo archivo.

Tipo: PutFilesDialogParameters.
La estructura que contiene los parámetros del cuadro de diálogo que se mostrará al usuario.

Tipo: UUID.
El UUID del formulario que se puede obtener con la propiedad UUID de un formulario de aplicación cliente. El archivo se guarda en un almacenamiento temporal y se elimina después de que se elimina el objeto de formulario.
Si omite este parámetro, el valor almacenado se borra después de la siguiente llamada al servidor desde un módulo común, o en una llamada al servidor de contexto o no de contexto desde un formulario, o en una llamada al servidor desde un módulo de comando, o al obtener un formulario.

Descripción de la variante del método:

Muestra el cuadro de diálogo de selección de archivo y coloca un archivo del sistema de archivos local en el almacenamiento temporal.
La extensión de operación de archivo no es necesaria en el cliente web.

Valor devuelto:

Tipo: Promise.
El resultado de la ejecución de la promesa son los detalles del archivo colocado en el almacenamiento temporal StoredFileDescription o Indefinido si se canceló la colocación del archivo en el almacenamiento temporal.

Descripción:

Función asíncrona. Coloca un archivo en el almacenamiento temporal.

Disponibilidad:

Cliente ligero, cliente web, cliente móvil, cliente grueso, aplicación móvil (cliente).

Véase también:

Contexto global, método BeginPutFile
Contexto global, método BeginPutFileToServer
Contexto global, método BeginPutFilesToServer
Contexto global, método PutFile
Contexto global, método PutFiles
Contexto global, método PutFilesToServerAsync

Disponible desde:

Disponible desde la versión 8.3.18.

---